<?php

if (! defined ( 'BASEPATH' ))
	exit ( 'No direct script access allowed' );
/**
 * CodeIgniter
 *
 * An open source application development framework for PHP 5.1.6 or newer
 *
 * @package		CodeIgniter
 * @author		ExpressionEngine Dev Team
 * @copyright	Copyright (c) 2008 - 2011, EllisLab, Inc.
 * @license		http://codeigniter.com/user_guide/license.html
 * @link		http://codeigniter.com
 * @since		Version 1.0
 * @filesource
 */

// ------------------------------------------------------------------------


/**
 * CodeIgniter Array Helpers
 *
 * @package		CodeIgniter
 * @subpackage	Helpers
 * @category	Helpers
 * @author		ExpressionEngine Dev Team
 * @link		http://codeigniter.com/user_guide/helpers/array_helper.html
 */

// ------------------------------------------------------------------------


/**
 * Element
 *
 * Lets you determine whether an array index is set and whether it has a value.
 * If the element is empty it returns FALSE (or whatever you specify as the default value.)
 *
 * @access	public
 * @param	string
 * @param	array
 * @param	mixed
 * @return	mixed	depends on what the array contains
 */
if (! function_exists ( 'element' )) {
	function element($item, $array, $default = FALSE) {
		if (! isset ( $array [$item] ) or $array [$item] == "") {
			return $default;
		}
		
		return $array [$item];
	}
}

// ------------------------------------------------------------------------


/**
 * Random Element - Takes an array as input and returns a random element
 *
 * @access	public
 * @param	array
 * @return	mixed	depends on what the array contains
 */
if (! function_exists ( 'random_element' )) {
	function random_element($array) {
		if (! is_array ( $array )) {
			return $array;
		}
		
		return $array [array_rand ( $array )];
	}
}

// --------------------------------------------------------------------


/**
 * Elements
 *
 * Returns only the array items specified.  Will return a default value if
 * it is not set.
 *
 * @access	public
 * @param	array
 * @param	array
 * @param	mixed
 * @return	mixed	depends on what the array contains
 */
if (! function_exists ( 'elements' )) {
	function elements($items, $array, $default = FALSE) {
		$return = array ();
		
		if (! is_array ( $items )) {
			$items = array ($items );
		}
		
		foreach ( $items as $item ) {
			if (isset ( $array [$item] )) {
				$return [$item] = $array [$item];
			} else {
				$return [$item] = $default;
			}
		}
		
		return $return;
	}
}

/* End of file array_helper.php */
/* Location: ./system/helpers/array_helper.php */